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1. About this guide 


Objectives and target audience 
This guide describes how to install and configure the Skrill Shopware module. It assumes that you have 
an existing Shopware installation. 


Conventions used in this guide 
The table below lists some of the conventions used in this guide. 


Table 1-1: List of conventions 

















Convention Description 

Code example Used to illustrate example code, functions and commands. 
File path Used to indicate a file path or folder structure. 

Glossary Glossary term 

Menu1 > Menu option2 > Indicates a menu path. 
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2. Introduction 


What is the Shopware module? 
Shopware is an eCommerce platform, which provides online merchants with a flexible shopping cart 
system, as well as control over the look-and-feel, content and functionality of their online store. 


Shopware has been fully integrated with Skrill’s online payment solution called Quick Checkout. 
Installing and configuring the Skrill Payment Solution module provides a simple, secure and convenient 
option for connecting to Skrill’s online payment processing platform via Shopware. 


Skrill customers using Shopware have access to a wide range of card and alternative payment methods. 


Signing up for a Skrill account 
Before you can start accepting payments through Skrill, you need to open a free merchant account by 
completing the online application form here. 


Once your application has been approved you can configure your Skrill credentials in your Skrill 
merchant account and then copy them in the your Shopware backend and start taking payments. 
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3. Installing and configuring Shopware 


Secret Word and API Password 

It is mandatory to setup a secret word and API/MQI password for your Skrill merchant account before 
configuring the Skrill Shopware module. The secret word is used to authenticate the data sent back to 
your Shopware server after payment. You must obtain the IP address of your Shopware server to 
configure the API/MQI password. You can find this IP address by executing the following command 
from a command prompt: 

ping <server domain name> 

For example: 


ping example. shopwareserver.com 
Pinging example. shopwareserver.com [145.76.160.206] with 32 bytes of data: 


Make a note of the set of numbers in the square brackets. This is the IP address. Now you have the IP 
address, you can setup the secret word and API/MQI password as follows: 


Log in to your Skrill merchant account at www.skrill.com 


1 

2. Go to Settings > Developer Settings (Figure 3-1) 

3. Set API / MQI Password using the toggle, type and confirm by clicking Save 

4. For each section, specify the IP address(es) or IP address range of your Shopware server 
This prevents payment or money transfer requests from other IP addresses if your secret 
word or API password is compromised. All requests from other IP addresses are denied. 
Access can be granted to: 


e Asingle IP address (e.g. 145.76.160.206 using the example above) 
e Multiple IP addresses, separated by space (e.g. 192.168.0.2 10.0.0.2) 


e Asubnet in CIDR notation (e.g. 192.168.0.0/24) 

5. Set Secret Word using the toggle, type and confirm by clicking the Save button 
Note: Your Secret Word must contain at least: 8 characters, 1 uppercase letter, 1 lowercase 
letter, and 1 number. 
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Bla Bla Wallet 
fè Banking ID: 116404455 
@ Balances Developer Settings : Bla Bla Wallet I mmm E45 Si SE mu DI ba Fel Si mm 
© Al Transaction Wallet IP Whitelisting API / MQ! / GSR / CVT Management API Documentation 
© User 
C Automated Payment Interface (API) Disabled ©] 
@ Settings 
Allow requests to the API only from the following IP addresses. 
Da ett Your API secure IP addresses: ( Edit ) + add) 
E3 Developer Settings 
87.120.141.129 


) Merchant Query Interface (MQI) Disabled 


Allow requests to the MQI only from the following IP addresses. 


Your MQI secure IP addresses: + Add 


No active secure IP address found 





[E Gateway Secure Restriction (GSR) Disabled 


Allow gateway sessions to be generated only from the following IP addresses. 


Your GSR secure IP addresses: 


©) SetAPI/MQIPassword Enabled 


Please provide API/MQI Password in order to enable the service. 


Current Password 
New Password 


Confirm Password 


E SetSecretWord Enabled 


Please provide Secret Word in order to enable the service. 


New Password 


Confirm Password 


ae 
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Figure 3-1: Configuring a Secret Word and API/MQI Password 


Download Skrill on your Shopware backend 
The next stage of the Shopware integration is to configure the Shopware module to connect to your 
Skrill account. The steps are as follows: 


1. Login to your Shopware admin account 
2. Select Modules and Services 
3. Click on Configuration 
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4. Goto Plugin Manager 
5. Type Skrill in the search bar 
6. Click on Skrill to configure your account (Figure 3-2) 
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Hide Login 


Figure 3-2: Skrill Settings with example values in Shopware backend 


Configure Skrill Settings 
Configure the Skrill Settings as follows: 


1. Enter your Skrill Merchant account email address 
2. Enter the Secret word that you set up in the previous section 
3. Enter your website for which you would like to accept payment via Skrill 


Table 3-1: Skrill Settings 





Field Name Description Format/ Example 





Merchant Account The email address linked to your Skrill merchant | techpubs@skrill.com 
(email) account (created by you when you first signed 
up for a Skrill merchant account). 





Shop URL URL for the home page of your shop without the | https://myshop.com 
index.php e.g. if your shop is located at 
https://myshop.com/index.php you would enter 
https://myshop.com 





Secret word Enter the secret word configured for your Skrill | N/A 
account here. This feature is mandatory and 
ensures the integrity of the data posted back to 
your Shopware servers. 
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4. Customer Experience 
This section describes the customer’s checkout experience when using the Skrill Shopware module. 


Note: We only describe the Checkout process from the payment selection step onwards as the previous 


steps are unchanged. 


The steps are as follows: 


1. Click a payment method from the list of available payment methods (this list depends on the 
customer’s country, the payment options configured for your Skrill account and the payment 
options configured in the Skrill Shopware Module 


choose payment method 


©O MAESTRO 


> 


O MASTERCARD 


€ 191.90 





Further > 


Figure 4-1: Shopware Checkout Payment selection showing different payment methods 
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2. Enter Payment details in the Skrill Payment Form 


® English Germany 


179.95&UR ©  Semoshop 


Skrill =p RAPIDI © 


Card number 


Expiry date Security code 
MM YY CVV 


Cardholder name 


Type the name exactly as it appears on the card 


PAY NOW 


Cancel 
= Powered by 
wi Skrill 


Figure 4-2: Enter Payment Details in the Skrill Payment Form 
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3. Click Pay Now to complete the payment. If all is correct, the payment form will display the 
following screen: 


@ English Germany 


179.95=UR © |  emoshop 


Vf 





Successful payment 


Oe= Skrill 


Figure 4-3: Successful Payment 


4. Click Continue to return to the Shopware Order Confirmation screen. This screen contains the 
unique order number for this payment. 


Thank you for your order at shopware Demoshop! 


We have emailed you an order confirmation. 
We recommend printing out the order confirmation listed below. 


< Back to the shop Print your order confirmation now! 


Please note that the print function is not available on all available devices. 


Billing and shipping address information 


Order number: 20032 


Mr Customer 1 
Transaction number: 880069093 


High Street 
Selected payment method: VISA 


21345 Berlin 
Germany 
items number total 
(SW) HYBRID JACKET White XL 
Order number: SW10133.4 1 € 179.95 * 
‘ t 
Total: € 179.95 * 
Shipping: € 0.00 * 
Total: € 179.95 
Total excluding VAT. €151.22 
€ 28.73 


excl. 19% value-added tax. 


Figure 4-4: Order Confirmation in Shopware Checkout 
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Removing or reducing the header and reducing the footer 

You can request a version of the Skrill payment form without the Skrill header and amount fields. The 
security logo is also removed from the footer, to reduce its size. To enable this option, please contact 
Skrill Merchant Services and ask for the Reduced Header and Footer option. This option is shown in 
the screenshot below (The standard payment form is shown on the left and the reduced header and 
footer option on the right). 


© Engish France 
10.00«ve : 
@ Engish France © English REIR 
= 0 = = 
d = 
-= © =p © 
visa SD 
visa SD vss € 
a _—_ 
Expiry date Sec code 
MM YY CV = s ya Expiry date Security code 
MM | YY cvv = 
MM | YY cw E 
Cardholder name Cardholder name 
First Last First 5 Cardholder name 
irst Last 
First Last 
Email address Why? Email address Why? 
Email address Why? 
Ponwes ty Powered by 
v Skrill Zm- Skrill Powered by Skrill 


Figure 4-5: Reduced Header and Footer Optio 
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5. Testing 


We provide test cards shown in the table below for use with test merchant accounts. When using these 
card numbers enter an expiry date in the future and a random CVV number. 


Table 5-1: Test Cards 











Brand Card Number 
MasterCard 5438311234567890 
Visa 4000001234567890 














Should you wish to test Skrill in DEMO shops please get in touch with Skrill support at 
newbusiness@paysafe.com, so we can provide you with access. 
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